Summary

• promote the DeepWiki badge and tighten the README badge surface
• move the main README to a top-first decision guide for one-off export, local recurring analysis, Databricks, and Palantir Foundry
• replace bullet-style command references with fenced bash examples
• clarify that .memory/ is only the repo default, not a required output location
• separate end-user/operator docs from contributor-oriented CLI docs
• add a demo storyboard doc for future screenshots and video capture

Verification

• validated badge and doc URLs with curl -I
• python ~/.agents/skills/readme-maintainer/scripts/readme_facts.py --repo . --format markdown
• cargo fmt --all --check
• cargo clippy --workspace --all-targets --all-features -- -D warnings
• cargo test --workspace